package com.liming.admin.service;

import com.liming.common.pojo.vo.dashboard.*;

import java.util.List;
import java.util.Map;

/**
 * @author liming
 * @date 2025/3/7
 */
public interface DashboardService {

    /**
     * 获取顶部卡片统计数据
     *
     * @return TopCardVO
     */
    TopCardVO topCard();

    /**
     * 用户注册  日期 - 数量
     *
     * @param scope 时间范围
     * @return List<UserRegister>
     */
    List<UserRegister> userRegister(String scope);

    /**
     * 用户数据大屏顶部统计卡片
     *
     * @return UserTopCardVO
     */
    UserTopCardVO userTopCard();

    /**
     * 用户性别统计
     *
     * @return Map<Long, Long>
     */
    Map<Integer, Long> userGender();

    /**
     * 用户消费排行
     *
     * @return List<UserConsumeRankVO>
     */
    List<UserConsumeRankVO> userConsumeRank();

    /**
     * 客户评论顶部统计卡片
     *
     * @return CustomerReviewTopCardVO
     */
    CustomerReviewTopCardVO customerReviewTopCard();
}
